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Meet Jeremy Likness | @jeremylil 


e Principal Architect at ¡Vision 
- Focused on Microsoft stack Enterprise Applicatis 
- http://csharperimage.jeremylikness.com/ 


- Former Certified Fitness Trainer and Specialist in 
Performance Nutrition 


e Over 20 Years of Professional Experience 
- 4-time Author incl. Programming the Windows Runtime by 
Example 
- Prolific speaker at conferences including DevLink, 
CodeStock, and the Microsoft Worldwide Partner 
Conference 


Meet Christopher Harrison | @geeki 


Content Developer, Microsoft 
Focused on web and Office 365 development 
Microsoft Certified Trainer 
Regular presenter at conferences 


Long time geek 
Still misses his Commodore 64 


Periodic blogger at http://blog.geektrainer.com 


Marathoner, husband, father of one four legged child 


Course Topics 


Web API Design 


01 | Introduction to Web API 04 | Validation and Error Handling 


02 | Basic Web API Design 05 | Security 


03 | Configuration 06 | Advanced Web API Design 


Setting Expectations 


e Target Audience 
- Web Application Developer 
- Interested in building public-facing RESTful APIs 
- Would like to expand knowledge of Web API design 


e Suggested Prerequisites/Supporting Material 
- Visual Studio 2013+ 


Join the MVA Community! 


e Microsoft Virtual Academy 
- Free online learning tailored for IT Pros and Developers 
- Over 2.6M registered users 


- Up-to-date, relevant training on variety of Microsoft 
products 


e “Earn while you learn!” 
- Get 50 MVA Points for this event! 


- Visit http://aka.ms/MVA-Voucher 
- Enter this code: WebAPlDesign (expires 4 Mar 15) 
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O1 | Introduction to Web API 


Jeremy Likness | Principal Architect 
Christopher Harrison | Content Developer 


Module Overview 


e ASP.NET Web API 
e Web API Design 
e REST 

e HATEOAS 

e Scaffolding 
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ASP.NET Web API 


Overview 


ASP.NET Web API 


e Option for web applications 
e Makes it easy to build HTTP-based services 
e Ideal for RESTful Als A 


E boi J services that can reach a broad range of clients 


including browsers and mobile devices. 
Empty Web Forms Web API 


cs cs Learn more 
51 6] 


Single Page Azure 
Application Mobile 
Service 


Change Authentication 


Authentication: Individual User Accounts 


Add folders and core references for: g só ZÉ Microsoft Azure 


C Web Forms [V MVC [Y Web API © O Host in the cloud 
Website 
C] Add unit tests 


Signed in as j.likness@live.com 


Test project name: |WebApplication1.Tests Manage Subscriptions 


OK Cancel 
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Web API Design 


What this course covers 


But what is Web API design? 


e An intentional approach to building APIs 


e A “must have” if your APIs will be consumed by third- 
party services 


e Attention to details: 
- How consumable is the API (signature, content 
negotiation)? 
- Does it comply with standards (response codes, etc.)? 
- Is it secure? 
- How do you handle multiple versions? 
- Is it truly RESTful? 
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REST 


Microsoft 


Introduction and overview of Representational State 
Transfer 


Representational State Transfer (REST) 


e Client-server 

e Stateless 

e Resource-based (vs. remote procedure call) 
e HTTP methods (GET, POST, PUT, DELETE) 

e Indempotency and side effects 

“It's a style, not a standard 

e Don't hate on HATEOAS 
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HATEOAS 


Hypermedia as the Engine of Application State 


Hypermedia as the Engine of 
Application State (HATEOAS) 


e Hypermedia is the key 

e It all starts at a URL 

e Resources are returned 

e Media types and locations are included 
e References based on state 
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DEMO 


REST and HATEOAS in Action 
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Scaffolding 


Generation of Web API projects out of the box with 
Visual Studio 
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DEMO 


Scaffolding 
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